<ilasm>

[This is preliminary documentation and subject to change.]

Compiles ILASM programs.

Parameters

Attribute	Type	Description	Required
target	string	Specifies which output type should be generated.	True
alignment	int	Instructs the compiler to set the FileAlignment value in the PE header.	False
base	int	Instructs the compiler to set the ImageBase value in the PE header.	False
clock	bool	Specifies whether or not the compiler should measure and report the compilation times.	False
debug	bool	Specifies whether or not the compiler should generate debug information.	False
error	bool	Specifies whether or not the compiler should attempt to create a PE file even if compilation errors have been reported.	False
flags	int	Instructs the compiler to set the Flags value in the CLR header.	False
keyfile	file	Instructs the compiler to generate a strong signature of the PE file.	False
keysource	string	Instructs the compiler to generate a strong signature of the PE file.	False
listing	bool	Specifies whether or not the compiler should type a formatted listing of the compilation result.	False
output	file	Specifies the name of the output file created by the compiler.	False
rebuild	bool	Instructs NAnt to recompile the output file regardless of the file timestamps.	False
resourcefile	file	Instructs the compiler to link the specified unmanaged resource file into the resulting PE file.	False
subsystem	int	Instructs the compiler to set the Subsystem value in the PE header.	False
failonerror	bool	Determines if task failure stops the build, or is just reported. The default is true.	False
if	bool	If true then the task will be executed; otherwise, skipped. The default is true.	False
timeout	int	The maximum amount of time the application is allowed to execute, expressed in milliseconds. Defaults to no time-out.	False
unless	bool	Opposite of `if`. If false then the task will be executed; otherwise, skipped. The default is false.	False
verbose	bool	Determines whether the task should report detailed build log messages. The default is false.	False

Framework-configurable parameters

Attribute	Type	Description	Required
exename	string	The name of the executable that should be used to launch the external program.	False
useruntimeengine	bool	Specifies whether the external program should be executed using a runtime engine, if configured. The default is false.	False

Nested Elements:

<sources>

Specifies the set of source files to compile.

</sources>

<arg>

The command-line arguments for the external program.

Contains a collection of <arg> elements.

</arg>

Examples

Compiles helloworld.il to helloworld.exe.

<ilasm target="exe" output="helloworld.exe" debug="true">
    <sources>
        <include name="helloworld.il" />
    </sources>
</ilasm>

Requirements

Assembly: NAnt.DotNetTasks (0.85.1714.0)